home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 2.iso / dist / fw_hylafax.idb / usr / freeware / catman / u_man / cat1 / ps2fax.Z / ps2fax
Text File  |  2002-07-08  |  6KB  |  136 lines
  1. PS2FAX(${MANNUM1_8})                 PS2FAX(${MANNUM1_8})
  2.  
  3.  
  4.  
  5. NNAAMMEE
  6.        ps2fax  -  image    POSTSCRIPT for facsimile transmission by
  7.        _H_y_l_a_F_A_X
  8.  
  9. SSYYNNOOPPSSIISS
  10.        $${{SSPPOOOOLL}}//bbiinn//ppss22ffaaxx [ _o_p_t_i_o_n_s ] [ _f_i_l_e_s...  ]
  11.  
  12. DDEESSCCRRIIPPTTIIOONN
  13.        _p_s_2_f_a_x takes POSTSCRIPT input and generates a TIFF Class    F
  14.        image  file  suitable  for  facsimile transmission.  It is
  15.        usually    invoked     by  the   _H_y_l_a_F_A_X   scheduler     process,
  16.        _f_a_x_q(${MANNUM1_8}).   On     Silicon  Graphics' IRIX systems,
  17.        this application    is based on  Adobe's  Display  POSTSCRIPT
  18.        software.   On  other machines POSTSCRIPT imaging is typi
  19.        cally done using    the freely  available  _G_h_o_s_t_s_c_r_i_p_t  soft
  20.        ware.
  21.  
  22.        _p_s_2_f_a_x  is  actually a link (symbolic or    otherwise) to the
  23.        script appropriate for the POSTSCRIPT imaging  tool.   The
  24.        link  is     setup    when the _f_a_x_s_e_t_u_p(${MANNUM1_8})    script is
  25.        run to configure    a _H_y_l_a_F_A_X server machine for use.
  26.  
  27.        Input files containing POSTSCRIPT may be    specified on  the
  28.        command    line.    If  none are given, then _p_s_2_f_a_x    will read
  29.        from standard input.
  30.  
  31.        By default, _p_s_2_f_a_x will generate     a  98    line/inch  output
  32.        document     whose    page width is 1728 pixels and page length
  33.        is 297 mm (a standard A4    page at    low  resolution).   Hori
  34.        zontal resolution is always 204 dpi.  Command line options
  35.        may be used to select alternate    vertical  resolution  and
  36.        page dimensions.
  37.  
  38.        If  no  filename     is  given, _p_s_2_f_a_x writes its output to    a
  39.        file named ppss..ffaaxx; the --oo option    can be used to specify an
  40.        alternate filename.
  41.  
  42.        By  default, output is compressed using the standard Group
  43.        3 1D-encoding scheme, with EOL codes padded to byte bound
  44.        aries.    If  the    --22 option is specified,    output is encoded
  45.        with the    optional Group 3 2D-encoding  scheme  (EOL  codes
  46.        are still padded    to byte    boundaries).
  47.  
  48.        Note  that  bbiinn//ppss22ffaaxx  is  usually just    a link to a shell
  49.        script that invokes the appropriate POSTSCRIPT RIP  to  do
  50.        the work.
  51.  
  52. OOPPTTIIOONNSS
  53.        The following operations    are recognized:
  54.  
  55.        --11     Write    Group  3  1D-encoded  data  to the output
  56.          file.
  57.  
  58.        --22     Write Group 3    2D-encoded  data  to  the  output
  59.          file.
  60.  
  61.        --mm _p_a_g_e_s     Set the maximum number    of pages that are permit
  62.          ted in    the output file.  If more pages    are  pre
  63.          sent  in  the input document then abort process
  64.          ing.
  65.  
  66.        --oo _f_i_l_e     Write output to the specified    _f_i_l_e  instead  of
  67.          the default ppss..ffaaxx filename.
  68.  
  69.        --ww _w_i_d_t_h     Set  the  output  page     _w_i_d_t_h,     in  pixels.   By
  70.          default, pages    are 1728 pixels    wide.
  71.  
  72.        --ll _l_e_n_g_t_h Set the output    page _l_e_n_g_t_h in    millimeters.   By
  73.          default, pages    are 297    millimeters long.
  74.  
  75.        --rr _v_r_e_s     Set  the  vertical resolution,    in lines/inch, at
  76.          which to image    the POSTSCRIPT.
  77.  
  78. RRUUNNTTIIMMEE    EENNVVIIRROONNMMEENNTT
  79.        Before  user-supplied  POSTSCRIPT   is    passed     to   the
  80.        POSTSCRIPT  interpreter,    a limited number of operators are
  81.        defined.     These operators are operators commonly    found  in
  82.        a  LaserWriter printer and (sometimes) generated    by Macin
  83.        tosh-based applications.
  84.  
  85.        The default Display POSTSCRIPT-based execution environment
  86.        includes    support    for the    following fonts:
  87.        AvantGarde-Book         Helvetica-Bold             Palatino-BoldItalic
  88.        AvantGarde-BookOblique     Helvetica-BoldOblique         Palatino-Italic
  89.        AvantGarde-Demi         Helvetica-Narrow         Palatino-Roman
  90.        AvantGarde-DemiOblique     Helvetica-Narrow-Bold         StoneSerif
  91.        Bookman-Demi         Helvetica-Narrow-BoldOblique     Symbol
  92.        Bookman-DemiItalic     Helvetica-Narrow-Oblique     Tekton
  93.        Bookman-Light         Helvetica-Oblique         Times-Bold
  94.        Bookman-LightItalic     Lithos-Bold             Times-BoldItalic
  95.        Courier             NewCenturySchlbk-Bold         Times-Italic
  96.        Courier-Bold         NewCenturySchlbk-BoldItalic     Times-Roman
  97.        Courier-BoldOblique     NewCenturySchlbk-Italic     ZapfChancery-MediumItalic
  98.        Courier-Oblique         NewCenturySchlbk-Roman         ZapfDingbats
  99.        Helvetica         Palatino-Bold
  100.        Note  that  this    is the same set    of fonts supported by the
  101.        DPS extension to    the X server.
  102.  
  103.        The default Ghostscript-based environment is  more  uncer
  104.        tain;  consult  the Ghostscript documentation for informa
  105.        tion on what fonts are available.
  106.  
  107. FFIILLEESS
  108.        ${SPOOL}/etc/dpsprinter.ps    POSTSCRIPT    code read at startup for DPS
  109.        /usr/lib/DPS/default.dps_vm   startup VM    file for DPS
  110.        /usr/lib/DPS/outline         Type 1 fonts for DPS
  111.        /usr/lib/DPS/prebuilt         prebuilt versions of fonts    for DPS
  112.  
  113. BBUUGGSS
  114.        Output from the Display POSTSCRIPT version of this command
  115.        is  encoded  according  to  the    Display    POSTSCRIPT binary
  116.        encoding    protocol.
  117.  
  118.        No prebuilt bitmap fonts    are currently available     for  the
  119.        DPS-based imager; this would greatly improve legibility at
  120.        low resolutions,    as the rendering of outline fonts  at  98
  121.        lpi is particularly poor.
  122.  
  123.        Both  DPS-  and Ghostscript-based versions of this program
  124.        fail  to     exit  with  non-zero  status  when  an      invalid
  125.        POSTSCRIPT  document  is    processed; this    makes it problem
  126.        atic for    the _H_y_l_a_F_A_X queue manager  to  determine  when    a
  127.        problem arises when preparing a job for transmission.
  128.  
  129. SSEEEE AALLSSOO
  130.        _s_e_n_d_f_a_x(1),    _f_a_x_q(${MANNUM1_8}),   _h_y_l_a_f_a_x_-_s_e_r_v_e_r_(_$_{_M_A_N_
  131.        _N_U_M_4___5_}_)
  132.  
  133.  
  134.  
  135.              August    26, 1996     PS2FAX(${MANNUM1_8})
  136.